|
|
1 Intro
Welcome to Tinymp3, a challenge entry for the mircscripts.org 'best mp3
player in a picwin under 10K.
To avoid emails or anything about
this, TinyMP3 was over 10,000 bytes, but not 10KB. The reason
is because traditionally 1KB is 1024 bytes, a power of 2. 1024 * 10 =
10240.
Now it's just huge and feature
filled.
Return to top
|
|
|
3 Installation
To install, type /load -rs <location of tinymp3final.mrc> in any window in mIRC.
Example: /load -rs tiny/tinymp3final.mrc
Then some text will pop up in the active and status windows stating
that TinyMP3 was loaded and that you must type /tm3 to run it. Do so to run it.
Return to top
|
|
|
4 Features
- Trippy Hue
Changer: TinyMP3 has a totally worthless and CPU
intensive huechanger which took days to
code. But it’s really fun to have on!
- Keyboard Shortcuts: TinyMP3 has built in keyboard shortcuts
for ease of use
- Mousewheel Support: TinyMP3 has extensive mousewheel support using Soul_Eater's mousewheel
DLL.
- Toolbar
Support: TinyMP3 has toolbar support using a
supplied DLL. TinyMP3 can also download the DLL for you if you
don’t have it. This means the player can run in the mIRC toolbar, and it also allows opening the playlist from the toolbar, and the window will
automatically return to the toolbar when you click away.
- Tons of Options : You can access the plethora of options
by right clicking on TinyMP3. Often Used options are in this menu,
and there are many many more options in
the "Other Options" submenu.
- Move Your Player: You can move the player by either clicking and dragging on the song
title/position or the sideways dragbar
on the left.
- Last Session Memory: When you close and reopen TinyMP3, it
will save your playlist and reload it so
that it is not lost! It will also remember which MP3 you were
playing and where you were in the playlist,
as well as what was selected, how big your player was, and whether
the playlist was on or not.
- Stop MP3 on close: you dont
have to stop the mp3 when you close tinymp3, but you can (in the
options popup)
- Snap!: Your player will 'snap' to the edge of
the screen when it comes within 10 pixels of it.
- Search MP3's: This option is in the options popup, a
keyboard
shortcut, and also accessable
with /fi in the channel editbox. Note: it is recommended that you use
/fi, because then, due to some weird
window parenting issues, youll be able
to just repeatedly press 'enter' until you find what you want.
- You can find the currently playing
mp3 by hitting the 'Find current' button in options popup or using
the keyboard
shortcut
- You can navigate the playlist with the keys ARROW UP and ARROW
DN, and play the selected item with ENTER
- The playlist
can collapse into the main window, the option is in the right
click popup or just double click in one of the draggable areas (song title & dragbar)
- Random play, in options popup
- Custom Color Set: don't like the colors of Tinymp3?
Change them in options popup
- Rearrange your playlist by dragging a selected item around
while holding the mouse button!
- Resize your player to make it the size you want, and then
you can also collapse the playlist
- You can 'spam a channel' with
what mp3 youre playing. The menu is in
your nicklist.
- Change the color of your channel spam,
located in the nicklist popup
- Change the channel to which TinyMP3 spams, note, it is compatible with
multi-server
- Auto Advance: when the currently playing item is
finished, Tinymp3 will move to the next item in the playlist and play it
- Load M3U: Tinymp3 can import M3U format playlists!
- Save and Load Tinymp3 Playlists in the options popup
- Add a directory to the playlist
using the options popup or keyboard shortcut
- Add a single MP3 to wherever your selection is using the
options popup or keyboard shortcut
- Remove the selected Playlist
entry in the options
popup
- ID3 support: Your playlist
will automatically update itself with ID3 info when you
play an entry. Please note that it will not update when you
load the files, as this would be slow when adding obscene amounts
of files.
- Double Position Slider: when you are changing the position in
your mp3, the title are will display ::SEEKING::
(place) and you will have a second slider on your position slider.
That way, you'll be able to see where the MP3 currently
is and where it will seek to. If you decide not to
seek, simply move your mouse up over the title text. Moving
down will result in moving the selected mp3.
- Play File Quick Button: This button is located next to the
'next song' button. It will allow you to play a file without
adding it to the playlist. This option
is also in the options popup.
- Autoscroll: When you resize the player so that the
title will not fit into the veiwing
area, it will automatically scroll.
Return to top
|
|
|
5 Keyboard Shortcuts
TinyMP3 has the following 22 keyboard shortcuts for ease of use:
[F]: Finds the currently playing file (also in
options popup)
[J]: Searchs all
filenames (and ID3's that have been entered into the playlist) for a string (also in options popup)
[A]: Opens the 'Add Dir' dialog (also in options
popup)
[INSERT]: Opens the 'Insert MP3 at selection' dialog
(also in options popup)
[I]: Opens the 'Insert Dir' dialog (also in
options popup)
[Z]: Equivalent to hitting the Previous Song
button
[X]: Equivalent to hitting the Play Song button
[C]: Equivalent to hitting the Pause button
[V]: Equivalent to hitting the Stop button
[B]: Equivalent to hitting the Next Song button
[O]: Opens the 'Open File' dialog (also in
options popup)
[T]: Puts the player in toolbar mode
[P] or [SHIFT+F9]: Toggles the playlist
on or off (also in options popup or double click on title/dragbar)
[DELETE]: Deletes the selection without asking
confirmation, so watch out
[HOME]: Scrolls the playlist
selector to the top
[END]: Scrolls the playlist
selector to the bottom
[PAGEUP]: Scrolls the playlist
selector up by one page
[PAGEDN]: Scrolls the playlist
selector down by one page
[-]: Volume Down
[+]: Volume Up
[ARROW LEFT]: Seek backward in the mp3 5 seconds
[ARROW RIGHT]: Seek forward in the mp3 5 seconds
[ARROW UP]: Moves the playlist
selector up (also scrolls to it if it is not on screen)
[ARROW UP+SHIFT]: Moves the playlist
selector up, but adds entries for multi-selection
[ARROW UP+CTRL]: Moves all selected entries up
[ARROW DOWN]: Moves the playlist
selector down (also scrolls to it if it is not on screen)
[ARROW UP+SHIFT]: Moves the playlist
selector down, but adds entries for multi-selection
[ARROW UP+CTRL]: Moves all selected entries down
[ENTER]: Plays the entry that has been selected by
the playlist selector
Return to top
|
|
|
6 Mousewheel
Support
TinyMP3 makes use of Soul_Eater's mousewheel DLL,
if it can be found:
In The Control Area:
[Up]: Volume Up
[Down]: Volume Down
[Up+CTRL]: Play Next Song
[Down+CTRL]: Play Previous Song
[Up+SHIFT]: Skip Forward in Song
[Down+SHIFT]: Skip Backward in Song
In The Playlist
Area:
[Up]: Scroll Up
[Down]: Scroll Down
[Up+CTRL]: Move selected song(s) up by one
[Down+CTRL]: Move selected song(s) down by one
[Up+SHIFT]: Scroll Up at 3 times your selected mousewheel scroll speed
[Down+SHIFT]: Scroll Down at 3 times your selected mousewheel scroll speed
[Up+SHIFT+CTRL]: Move selected song(s) up by your selected mousewheel scroll speed
[Down+SHIFT+CTRL]: Move selected song(s) down by your selected
mousewheel scroll speed
Return to top
|
|
|
7 How to edit Custom Colors
I thought it was reasonably straight forward, but I have decided to include
documentation anyway. To change the colors, simply hole your mouse
button down in the Red, Green, or Blue columns and then move the mouse.
The color will update in the player window.
To Change Colors: Right click in the
color editing window and select the color you wish to change.
TinyMP3 will always load your custom
colors on startup instead of the default colors.
Simply close the editing window when
done, and you will be set.
Return to top
|
|
|
8
QA
("bugs" & more)
Q: Menu for spam is in nicklist and menubar instead of tinyamp
window, what gives?
A: the menu for spam is generated via $submenu. In mIRC, $submenu doesnt
work in picture windows. I think this is actually a bug in mIRC, and I have emailed Khaled
about it. Update: Newer versions of mIRC
have this fixed, thanks to me. TinyMP3 has been likewise updated.
Q: I can only select one mp3 in my playlist.. why?
A: Space issue. Selecting more than one item would require quite
a bit more code, and there simply was no room in order to make it into
the challenge. Expect TinyMP3 SE to have it. Update: it does.
And more.
Q: TinyMP3 wont play network files in
format //blahblah/blah.mp3, why?
A: mIRC bug. You'll probably get an
error in your status window about /splay 'file not found'. $isfile returns true for the file, but /splay wont
play it. There is a solution though! Simply map a network drive to the
folder on the network, and then you can play the files that way.
Q: TinyMP3 wont play my MP3, why?
A: Your mp3 is probably not compatible with mIRC.
That, or your playlist
entry is messed up. I have also noticed some MP3's work with /splay only
after you /splay seek, so try moving the position bar.
Q: You ripped off ^Andy's spam color selector from mp3stuff!
A: I too thought it was too similar, and removed it. However,
^Andy told me to put it back in so everyone can see how much 'I wub him'.
Q: I have mp3's with double spaces in the filename and they wont play! wtf!
A: mIRC script has issues with
redundant spaces. This is fixable, but not practical for a challenge
entry.
Q: I had spam on, I reconnected, and then it stopped working! why?
A: In order to be compatible with multiserver,
TinyMP3 needs to remember the 'CID' of the server you want to spam to.
If you reconnect, that CID could change and be invalid, making it not
work.
Return to top
|
|
|
9 Credits
Tinymp3 was created by oS\2,
aka oSiRiS aka ^oS
Return to top
|
|
|
10
Greetings
^Andy,
EvilXeroX, Magnus`, nacitar,
nimper, eXonyte, Kamek, dohcan, fubar, tabo, Variant, shikkie,
Memo, ^TwoSock^, Soul_Eater
Return to top
|
|
|
|
